Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_GD_OPEN

EOS_GD_OPEN

This function creates a new file or opens an existing one.

Syntax

Result = EOS_GD_OPEN( filename, access [, /CREATE] [, /RDWR | , /READ] )

Return Value

Returns the grid file id handle (fid) if successful and FAIL(–1) otherwise.

Arguments

filename

Complete path and filename (string) for the file to be opened.

Keywords

CREATE

If file exists, delete it, then open a new file for read/write.

RDWR

Open for read/write. If file does not exist, create it.

READ

Open for read only. If file does not exist, error. This is the default.

Examples

In this example, we create a new grid file named, GridFile.hdf. It returns the file handle, fid.

fid = EOS_GD_OPEN("GridFile.hdf", /CREATE)

Version History

 

5.2

Introduced

See Also

EOS_GD_CLOSE